Skip to content

docs: add function docstring and readme example#31

Merged
sbillinge merged 3 commits intoPDF-bl:mainfrom
ycexiao:add-readme-example
Feb 10, 2026
Merged

docs: add function docstring and readme example#31
sbillinge merged 3 commits intoPDF-bl:mainfrom
ycexiao:add-readme-example

Conversation

@ycexiao
Copy link
Copy Markdown
Contributor

@ycexiao ycexiao commented Feb 10, 2026

What problem does this PR address?

Closes #3

Docstring for SequentialCMIRunner and examples are added

What should the reviewer(s) do?

Please see the modifications.

@codecov
Copy link
Copy Markdown

codecov bot commented Feb 10, 2026

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@ycexiao ycexiao marked this pull request as ready for review February 10, 2026 00:55
@ycexiao
Copy link
Copy Markdown
Contributor Author

ycexiao commented Feb 10, 2026

@sbillinge, it's ready for review. Also, do we want to deploy an online website to host the documentation?

@sbillinge
Copy link
Copy Markdown
Contributor

I can make it publishable but I think we have to build the docs using the CI to generate the gh-pages branch. Then I can go back and make it public.

Copy link
Copy Markdown
Contributor

@sbillinge sbillinge left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

This looks great! Just a few grumpy comments....

Parameters
----------
input_data_dir : str
Path to the directory containing input PDF profile files.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I am not sure if you remember, but all these should begin with The. If you are using LLM to help with these, that is fine but please can you train your LLM to do this! :)

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

sorry... I will remember this next time.

Default is None.
xmin : float
Minimum x-value for the PDF profile.
Default is the value prased from the input file.
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

typo (and below)

self._init_plots()

def init_plots(self):
def _init_plots(self):
Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

is this an initialization function? In which case I think _initialize_plots is more descriptive

Copy link
Copy Markdown
Contributor Author

@ycexiao ycexiao left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@sbillinge, it's ready for review.

Methods
-------
init_profile(profile_path, qmin=None, qmax=None, xmin=None, xmax=None, dx=None)
initialize_profile(profile_path, qmin=None, qmax=None, xmin=None, xmax=None, dx=None)
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

init -> initialize

Parameters
----------
input_data_dir : str
The path to the directory containing input PDF profile files.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Add the "The"

Default is the value parsed from the input file.
xmax : float
The maximum x-value for the PDF profile.
Default is the value parsed from the input file.
Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Typo fixed: prased -> parsed

@sbillinge sbillinge merged commit d214efa into PDF-bl:main Feb 10, 2026
6 checks passed
@ycexiao ycexiao deleted the add-readme-example branch February 12, 2026 04:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

doc: Expand description in Readme

2 participants